IRIX Base Documentation 2002 November

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / assign.z / assign

Wrap

Text File | 2002-10-03 | 53.1 KB | 1,025 lines

assign(1) Last changed: 3-25-99 NNAAMMEE aassssiiggnn - Assigns options for library file open processing SSYYNNOOPPSSIISS UNICOS and UNICOS/mk systems: aassssiiggnn [--aa _a_c_t_u_a_l_f_i_l_e] [--bb _b_s] [--cc] [--dd _b_d_r] [--ff _f_o_r_t_s_t_d] [--ll _b_u_f_l_e_v] [--mm _s_e_t_t_i_n_g] [--nn _s_z [:_s_t]] [--pp _p_a_r_t_l_i_s_t] [--qq _o_c_b_l_k_s] [--rr _s_e_t_t_i_n_g] [--ss _f_t] [--tt] [--uu _b_u_f_c_n_t] [--ww _s_e_t_t_i_n_g] [--xx _s_e_t_t_i_n_g] [--yy _s_e_t_t_i_n_g] [--CC _c_h_a_r_c_o_n] [--DD _f_i_l_d_e_s] [--FF _s_p_e_c[,,_s_p_e_c_s]] [--II] [--LL _s_e_t_t_i_n_g] [--NN _n_u_m_c_o_n] [--OO] [--PP _s_c_o_p_e] [--RR] [--SS _s_e_t_t_i_n_g] [--TT _s_e_t_t_i_n_g] [--UU _s_e_t_t_i_n_g] [--VV] [--WW _s_e_t_t_i_n_g] [--YY _s_e_t_t_i_n_g] [--ZZ _s_e_t_t_i_n_g] _a_s_s_i_g_n__o_b_j_e_c_t IRIX systems: aassssiiggnn [--aa _a_c_t_u_a_l_f_i_l_e] [--bb _b_s] [--ff _f_o_r_t_s_t_d] [--ss _f_t] [--tt] [--yy _s_e_t_t_i_n_g] [--BB _s_e_t_t_i_n_g] [--CC _c_h_a_r_c_o_n] [--DD _f_i_l_d_e_s] [--FF _s_p_e_c[,,_s_p_e_c_s]] [--II] [--NN _n_u_m_c_o_n] [--OO] [--RR] [--SS _s_e_t_t_i_n_g] [--TT _s_e_t_t_i_n_g] [--UU _s_e_t_t_i_n_g] [--VV] [--WW _s_e_t_t_i_n_g] [--YY _s_e_t_t_i_n_g] [--ZZ _s_e_t_t_i_n_g] _a_s_s_i_g_n__o_b_j_e_c_t IIMMPPLLEEMMEENNTTAATTIIOONN UNICOS, UNICOS/mk, and IRIX systems DDEESSCCRRIIPPTTIIOONN On IRIX systems, the aassssiiggnn command affects I/O statements in program units compiled with the MIPSpro 7 Fortran 90 compiler or compiled with the --ccrraayylliibbss option to the MIPSpro F77 compiler. The aassssiiggnn command associates options with Fortran unit numbers and file names for use during the library open processing. The ffffaassssiiggnn(3C) command provides an interface to assign processing from C. See the ffffaassssiiggnn(3C) man page for more details. When using direct access files on IRIX systems, the user must assign the file to either the ssyysstteemm or gglloobbaall layer for code that works with more than one processor. The default layer for direct access on IRIX systems is the ccaacchhee layer and it does not have the coherency to handle multiple processes doing I/O to the same file. Selected options on the aassssiiggnn command are available on IRIX systems. The descriptions of each option include the hardware platform where the option is available. The _a_s_s_i_g_n__o_b_j_e_c_t argument can take one of the following formats: ------------------------------------------------------------- Format Example Attribute association ------------------------------------------------------------- gg::_i_o__t_y_p_e gg::ssuu Sequential unformatted open request uu::_u_n_i_t__n_u_m_b_e_r uu::99 Fortran unit 9 pp::_p_a_t_t_e_r_n pp::ffiillee%% File names matching the pattern _f_i_l_e%% ff::_f_i_l_e__n_a_m_e ff::ffiillee11 File name ffiillee11 _f_i_l_e__n_a_m_e mmyyffiillee File name mmyyffiillee ------------------------------------------------------------- An _a_s_s_i_g_n__o_b_j_e_c_t that is a pattern may contain wildcard characters %% and __. The %% character matches any sequence of 0 or more characters; the __ character matches any single character. The run-time I/O library applies the options to a file connection whenever _a_s_s_i_g_n__o_b_j_e_c_t is opened. The application of options occurs whenever a file is opened by any of the following: * Fortran I/O Fortran OOPPEENN statement Implicit Fortran open via some I/O statement * FFIO ffffooppeenn(3C) library routine ffddccpp(1) command * Fortran auxiliary I/O WWOOPPEENN(3F) library routine OOPPEENNMMSS(3F) library routine OOPPEENNDDRR(3F) library routine AAQQOOPPEENN(3F) library routine When any of these I/O routines opens a file, they use aassssiiggnn options for any _a_s_s_i_g_n__o_b_j_e_c_t which applies to the open request. As many as five _a_s_s_i_g_n__o_b_j_e_c_t_s can apply to an open request: * gg::aallll applies to any open. * gg::ssuu, gg::ssff, gg::dduu, gg::ddff, gg::aaqq, and gg::ffff each apply to types of open requests (for example, Fortran sequential unformatted, Fortran sequential formatted, Fortran direct unformatted, Fortran direct formatted, AQOPEN, and ffffooppeenn, respectively). * uu::NN applies whenever Fortran unit _N is opened. * pp::_p_a_t_t_e_r_n applies whenever a file with a name matching _p_a_t_t_e_r_n is opened. The aassssiiggnn environment can contain only one pp::_a_s_s_i_g_n__o_b_j_e_c_t that matches the current open. The exception is that the pp::%% pattern is silently ignored if a more specific pattern also matches the current filename being opened. * ff::_f_i_l_e_n_a_m_e applies whenever a file with the name _f_i_l_e_n_a_m_e is opened. Options from the _a_s_s_i_g_n__o_b_j_e_c_ts in the above categories are collected to create the complete set of options used for any particular open operation. The options are collected in the above order, with options collected later in the list of _a_s_s_i_g_n__o_b_j_e_c_t_s overriding those collected earlier. On UNICOS and UNICOS/mk systems, assign information is stored in the aassssiiggnn environment file, $$TTMMPPDDIIRR//..aassssiiggnn, by default. The location of the active aassssiiggnn environment can be changed by assigning a file name or a process environment variable to the FFIILLEENNVV environment variable. On IRIX systems, you must set the FFIILLEENNVV environment variable to use the aassssiiggnn command. FFIILLEENNVV can contain the pathname of a file which will be used to store aassssiiggnn information, or it can specify that the information should be stored in the process environment. See the examples in the EXAMPLE section. There are two main groups of aassssiiggnn command options: control options and I/O processing options. This man page describes both types of options. CCoonnttrrooll ooppttiioonnss These options are available on IRIX systems and UNICOS and UNICOS/mk systems: --II Specifies an incremental assign. All options are added on to the options already assigned to the current _a_s_s_i_g_n__o_b_j_e_c_t. This option and the --OO option are mutually exclusive. --OO Specifies a replacement assign. All currently existing aassssiiggnn options for the current _a_s_s_i_g_n__o_b_j_e_c_t are replaced. This option is the default control option and is mutually exclusive from the --II option. --RR Removes all aassssiiggnn options for _a_s_s_i_g_n__o_b_j_e_c_t. If _a_s_s_i_g_n__o_b_j_e_c_t is not specified, all currently assigned options for all _a_s_s_i_g_n__o_b_j_e_c_ts are removed. --VV Views options for _a_s_s_i_g_n__o_b_j_e_c_t. If _a_s_s_i_g_n__o_b_j_e_c_t is not specified, all currently assigned options for all assign objects are printed. II//OO pprroocceessssiinngg ooppttiioonnss I/O processing options specify aspects of I/O processing. Each option applies to one or more supported I/O type: Fortran I/O, FFIO, or Fortran auxiliary I/O (AQIO, WAIO, DRIO, and MSIO). The special "default" option value is available for all aassssiiggnn attribute options with the exception of the --aa option. The "default" option value has the same effect as if the corresponding option were unspecified. It can be used to nullify an option value set in a more general type of aassssiiggnn. For example, the following commands show how you can set a buffer size of 20 blocks for all files except the file ssmmaallllffiillee: assign -b 20 g:all assign -b default f:smallfile OOppttiioonnss aanndd AArrgguummeennttss --aa _a_c_t_u_a_l_f_i_l_e Specifies the actual file name. Used by Fortran I/O and auxiliary I/O. Available on IRIX systems. When the --aa option is assigned to a unit, open processing for the unit results in a connection to _a_c_t_u_a_l_f_i_l_e. An error occurs if --aa has been specified for a unit that is opened with an explicit FFIILLEE== specifier in the OOPPEENN statement. When --aa is assigned to a file name, the file name becomes an alias for _a_c_t_u_a_l_f_i_l_e. When _f_i_l_e__n_a_m_e is specified as the FFIILLEE== specifier in an OOPPEENN statement, _a_c_t_u_a_l_f_i_l_e is opened instead of _f_i_l_e__n_a_m_e. A similar effect occurs if the llnn(1) command is used to establish a symbolic link. The --aa and --DD options cannot both be provided. --bb _b_s Specifies buffer size of the library's I/O buffer in units of 4096-byte blocks. Used by Fortran I/O and auxiliary I/O. Available on IRIX systems. On UNICOS and UNICOS/mk systems, the default buffer sizes in 4096-byte blocks are as follows. Sequential formatted 8 Sequential unformatted 48 (see the description of the ccooss layer in the IINNTTRROO__FFFFIIOO(3F) man page for details) Direct access formatted Minimum (record length + 1 byte, 8 blocks) Direct access Maximum (record length, 8 blocks) unformatted Direct access unformatted files have 4 buffers. On IRIX systems, the default buffer sizes in 4096-byte blocks are as follows: Sequential formatted 8 Sequential unformatted 8 Direct access formatted 16 Direct access 16 unformatted Direct files have 4 buffers. --cc Specifies contiguous storage. Must be used in conjunction with the --nn option. Used by Fortran I/O and auxiliary I/O. Deferred implementation on IRIX systems. Requests that contiguous disk space be allocated to the file. --dd _b_d_r Specifies automatic recovery of bad data for online tape files. Used by Fortran I/O and auxiliary I/O. Deferred implementation on IRIX systems. Valid values for _b_d_r are as follows: _b_d_r AAccttiioonn sskkiippbbaadd Skips bad data; no bad data is sent to your buffer. aaccppttbbaadd Accepts bad data; makes bad data available. When this option is used, explicit calls to the AACCPPTTBBAADD and SSKKIIPPBBAADD library routines are not necessary. You will receive an error code indicating that a bad tape block has been encountered. This option is valid only for online tape files. For online tape files specified with aassssiiggnn --FF [[bbmmxx,,ttaappee]] or aassssiiggnn --ss [[bbmmxx,,ttaappee]], only one tape block is accepted or skipped at a time. The --dd sskkiippbbaadd option is also valid for tape fields specified with the following command: aassssiiggnn --FF [[iibbmm..uu,, iibbmm..vvbbss,, iibbmm..vvbb,, iibbmm..vv,,ttaappee]] For these files, all consecutive bad tape blocks are skipped, and the user is placed at the beginning of the next record. The --dd option is invalid with all other file specifications. --ff _f_o_r_t_s_t_d This option specifies the type of Fortran with which to be compatible. Used by Fortran I/O. Valid values for _f_o_r_t_s_t_d are: 7777 Causes the Fortran file to be compatible with the FORTRAN 77 standard and Cray Research's CF77 compiling system. 9900 Causes the Fortran file to be compatible with ANSI X3.198-1991 (Fortran 90 and the Fortran 95 standard) and Cray Research's CF90 compiling system. iirriixxff7777 Causes the Fortran file to be compatible with Silicon Graphics' FORTRAN 77 compiling system which runs on IRIX systems. iirriixxff9900 Causes the Fortran file to be compatible with the MIPSpro 7 Fortran 90 compiling system. A file's compatibility is established at open time. By default, a Fortran file is compatible with the language from which an OOPPEENN statement or implicit open caused the file to be connected. Implicit opens which result from calls to RREEAADDCC, RREEAADDCCPP, WWRRIITTEECC, or WWRRIITTEECCPP result in Fortran 90/95 compatibility mode by default. --ll _b_u_f_l_e_v Controls kernel buffering; used by Fortran I/O, auxiliary I/O, and FFIO. Deferred implementation on IRIX systems. _b_u_f_l_e_v can be any of these values: nnoonnee Sets OO__RRAAWW and OO__LLDDRRAAWW llddccaacchhee Sets OO__RRAAWW, clear OO__LLDDRRAAWW ffuullll Clears OO__RRAAWW and OO__LLDDRRAAWW If this option is not set, the level of system buffering is dependent on the type of open operation being performed. --mm _s_e_t_t_i_n_g Activate or suppress special handling of a file which will be accessed concurrently by several processes or tasks. Used by Fortran I/O and auxiliary I/O. Not available on IRIX systems. Special handling includes skipping the check that only one Fortran unit be connected to a unit. _s_e_t_t_i_n_g can be oonn or ooffff. For files which are written, special handling also includes: * Suppressing file truncation to true size by the I/O buffering routines. Library buffer routines are usually flushed to disk in their entirety, and a truncation of the file at close time is done to trim the last file page to the correct size. * Ensuring that the file will not be truncated after the last record written on sequential files (--mm oonn implies --TT ooffff). If the file will be updated, the user is responsible for partitioning file access from all processes, tasks, or processing elements (PE) on library buffer page boundaries. This can be done in the following ways: * Specify the --bb aassssiiggnn option. * Specify the first numeric parameter on the ccaacchhee or bbuuffaa FFIO layers (for example, --FF ccaacchhee::22 or --FF bbuuffaa::88). * Specify no library buffering by using the --FF ssyysstteemm option. For example, if several PEs concurrently open a file and specify --mm oonn, each PE might by convention update region MMYY__PPEE(()) of the file. If the region size for each PE is 10 blocks, the following aassssiiggnn options could be specified: aassssiiggnn --mm oonn --FF ccaacchhee::55 uu::11 Specifying a buffer page size of 5 in this example assures alignment with PE file region boundaries because the region size (10) is an integral multiple of the buffer page size (5). --nn _s_z [:_s_t] Amount of system file space to reserve for a file. This is a number of 4096-byte blocks. Used by Fortran I/O, FFIO, and auxiliary I/O. Deferred implementation on IRIX systems. If this option is used with an existing file, _s_z 4096-byte blocks are added to the end of the file by use of iiaalllloocc(2). NOTE: Allocation of actual file space is not done until the file is opened in the Fortran libraries. For immediate allocation, use the sseettff(1) command . The optional _s_t value is an obsolete way to specify the --qq aassssiiggnn option. Use of --qq is preferable to using the _s_t value on --nn. --pp _p_a_r_t_l_i_s_t File system partition list. Used by Fortran I/O, FFIO, and auxiliary I/O. _p_a_r_t_l_i_s_t indicates the partitions of a file system on which a file is to be allocated. Deferred implementation on IRIX systems. _p_a_r_t_l_i_s_t is used at file creation time by use of the _c_b_i_t_s argument on the ooppeenn(2) system call. _p_a_r_t_l_i_s_t also controls the partitions where space is allocated using iiaalllloocc(2) when a --nn option is assigned. _p_a_r_t_l_i_s_t can be a single number, a range (_m--_n), a set (_m::_n), or a combination of ranges and sets separated by colons. The dash (--) in the range specifies a range of partitions to be used (for example, 2--5 means partitions 2 through 5). A colon (::) in the set specifies a list of partitions to be used (for example, 2:4:6 means partitions 2, 4, and 6). Partitions are numbered starting with 0. You can use the ddff(1) command with the --pp option to display partitions on one or more file systems. --qq _o_c_b_l_k_s Number of 4096-byte blocks to be allocated per file system partition. Used by Fortran I/O, FFIO, and auxiliary I/O. _o_c_b_l_k_s is used at file creation time by use of the _c_b_l_k_s argument on the ooppeenn(2) system call. _o_c_b_l_k_s also controls the number of blocks assigned per partition where space is allocated using iiaalllloocc(2) when a --nn option is assigned. Deferred implementation on IRIX systems. --rr _s_e_t_t_i_n_g Activates or suppresses the passing of the OO__RRAAWW flag to the ooppeenn(2) system call. Used by Fortran I/O and FFIO. _s_e_t_t_i_n_g can be either oonn or ooffff. This option is supported in programs linked with Cray Research's Programming Environment 3.0 and later releases. Not available on IRIX systems. --ss _f_t Specifies the file type. Used by Fortran I/O. See below for specific values supported on IRIX systems. The file type defines the way records are delimited and how end-of-file is represented. Some _f_t values also define the internal processing used for a file. Enter one of the following for _f_t: _f_t FFiillee TTyyppee bbiinn Unblocked file structure with buffering. Available on IRIX systems. ccooss or bblloocckkeedd COS blocked structure. This is the default structure for sequential unformatted files on UNICOS and UNICOS/mk systems. Available on IRIX systems. ssbbiinn Unblocked file structure with "stdio" style buffering. The Fortran I/O library issues I/O which is compatible with the C ffwwrriittee(3C) and ffrreeaadd(3C) functions. This file type is useful for accessing pipe files. It is not permitted with formatted files. Available on IRIX systems. ttaappee or bbmmxx On UNICOS systems and UNICOS/mk systems, this indicates the online tape access method. This file structure is required for doing any type of Fortran I/O (formatted, unformatted, or buffer I/O) to an online tape file. Each read or write request results in the processing of one tape block. This structure may be used only with online IBM-compatible tape files or with ER90 volumes mounted in block mode on UNICOS systems (see the _T_a_p_e _S_u_b_s_y_s_t_e_m _U_s_e_r'_s _G_u_i_d_e, for more information about restrictions on record sizes when using ER90 block mode). Not available on IRIX systems. tteexxtt New-line characters delimit the records. This is the default structure for sequential formatted files. On UNICOS and UNICOS/mk systems, it is also the default structure for direct-access formatted files. Available on IRIX systems. uu Each read or write request results in an immediate system call. Requests should be made in multiples of 4096 bytes for best performance. Available on IRIX systems. uunnbblloocckkeedd Adjacent records are not delimited from one another. This is the default structure for direct-access unformatted files. On IRIX systems, it is also the default structure for direct-access formatted files. Available on IRIX systems. Each file type has a set of valid access methods associated with it. The following table lists the valid access methods for each of the file types. In this table, "yes" indicates that the access method is allowed; "no" indicates that it is not allowed; "default"indicates that it is the default method on UNICOS, UNICOS/mk, and IRIX systems. -------------------------------------------------------------- Sequential Sequential Direct Direct formatted unformatted formatted unformatted -------------------------------------------------------------- bbiinn No Yes Yes Yes ccooss||bblloocckkeedd Yes Yes ** No No ssbbiinn Yes Yes Yes Yes tteexxtt Default No Yes ** No uu No Yes Yes Yes uunnbblloocckkeedd No Yes Yes *** Default ttaappee||bbmmxx* Yes * Yes * No * No * -------------------------------------------------------------- * Not available on IRIX systems ** Default on UNICOS and UNICOS/mk systems *** Default on IRIX systems --tt Temporary file. Used by Fortran I/O. Available on IRIX systems. This causes the file to be deleted when it is disconnected by using a CCLLOOSSEE statement or at program termination. Unlike SSTTAATTUUSS==''SSCCRRAATTCCHH'' on OOPPEENN, the --tt option does not affect the default file name selected for a unit. If SSTTAATTUUSS==''KKEEEEPP'' is specified on the CCLLOOSSEE statement, it is silently ignored without error or warning. --uu _b_u_f_c_n_t Buffer count. Used by Fortran I/O. Deferred implementation on IRIX systems. Specifies the number of buffers to be allocated for a file. This option can be used with direct-access unformatted files and with online tape files (UNICOS and UNICOS/mk systems). The default is 4 for direct-access unformatted files and is system-dependent for online tape files. --ww _s_e_t_t_i_n_g Activate or suppress the passing of the OO__WWEELLLLFFOORRMMEEDD flag to the ooppeenn(2) system call. Used by Fortran I/O and FFIO. _s_e_t_t_i_n_g may be oonn or ooffff. Deferred implementation on IRIX systems. --xx _s_e_t_t_i_n_g Activate or suppress the passing of the OO__PPAARRAALLLLEELL flag to the ooppeenn(2) system call. Used by Fortran I/O and FFIO. _s_e_t_t_i_n_g may be oonn or ooffff. This option is supported in programs linked with Cray Research's Programming Environment 3.0 and later releases. Not available on IRIX systems. --yy _s_e_t_t_i_n_g Suppress repeat count in list-directed output. _s_e_t_t_i_n_g can be oonn or ooffff. The default setting is ooffff. --BB _s_e_t_t_i_n_g Activate or suppress the passing of the OO__DDIIRREECCTT flag to the ooppeenn(2) system call. Used by Fortran I/O and FFIO. _s_e_t_t_i_n_g may be oonn or ooffff. Available only on IRIX systems. Not available on UNICOS or UNICOS/mk systems. This option is supported by the ccaacchhee, ccaacchheeaa, and ssyysstteemm layers (see the --FF option). Use of --BB with the ssyysstteemm layer requires that the user properly align their I/O requests. The ccaacchhee and ccaacchheeaa layers will guarantee proper alighment when --BB is specified. See the ooppeenn(2) man page for more information about OO__DDIIRREECCTT. --CC _c_h_a_r_c_o_n Specifies character set conversion. Used by Fortran I/O. This requests that certain I/O processors (currently limited to the Fortran I/O libraries) convert character data from this assumed character set on input and convert it to this character set on output. _c_h_a_r_c_o_n must be one of the following: aasscciiii (no-op) eebbccddiicc * ccddcc * * Not supported on UNICOS/mk or IRIX systems. --DD _f_i_l_d_e_s Specifies connection to a standard file. Used by Fortran I/O. Available on IRIX systems. The --DD and --aa options cannot be used together. Enter one of the following for _f_i_l_d_e_s: _f_i_l_d_e_s FFiillee ssttddiinn Connect to file descriptor 0 ssttddoouutt Connect to file descriptor 1 ssttddeerrrr Connect to file descriptor 2 --FF _s_p_e_c[,,_s_p_e_c...] FFIO specification. This is a comma-separated list of layers through which data is to be passed. Used by Fortran I/O, auxiliary I/O, and FFIO. See the IINNTTRROO__FFFFIIOO(3F) man page for details about the FFIO specifications and for details on which layers are available on IRIX systems. Each layer specification is of the following general form: _c_l_a_s_s[.._t_y_p_e[.._s_u_b_t_y_p_e]][::[_n_u_m_1]::[[_n_u_m_2]::[_n_u_m_3]] For each class, _c_l_a_s_s specifies the class of processing to be done. Many _c_l_a_s_s values also accept _t_y_p_e and/or _s_u_b_t_y_p_e fields to modify their behavior; other _c_l_a_s_s values accept only the _c_l_a_s_s itself (for example, ssyyssccaallll). Following the _t_y_p_e and _s_u_b_t_y_p_e fields, many classes accept numeric fields to further tune or modify the file processing. Units in these numeric fields differ depending on _c_l_a_s_s. All specification lists end, either implicitly or explicitly, with the ssyysstteemm layer. If this layer is not specified, it is added automatically. Acceptable values for _c_l_a_s_s are as follows: _c_l_a_s_s VVaalluuee bbllaannkkxx or bbllxx Blank compression filters. Not available on IRIX systems. bbmmxx or ttaappee Online tape handlers. Deferred implementation on IRIX systems. bbuuffaa Buffering layer. Available on IRIX systems. cc220055 CDC CYBER 205/ETA record formats. Not available on IRIX systems. ccaacchhee Cache layer. Available on IRIX systems. ccaacchheeaa Asynchronous ccaacchhee layer. Available on IRIX systems. ccddcc CDC 60-bit record format. Not available on IRIX systems. ccooss or bblloocckkeedd COS blocking; default for Fortran sequential unformatted I/O on UNICOS and UNICOS/mk systems. Available on IRIX systems. eerr9900 ER90 handlers. Not available on IRIX systems or on CRAY T3E systems. eevveenntt Event layer, used to monitor I/O activity between layers. This layer generates statistics in the form of an ASCII log file. Deferred implementation on IRIX systems. ff7777 FORTRAN 77/UNIX Fortran record blocking. Available on IRIX systems. This is the default structure for sequential unformatted files on IRIX systems. ffdd Open a specific file descriptor. Available on IRIX systems. gglloobbaall UNICOS/mk and IRIX shared file. This is a caching layer which distributes the cache across all PEs. See the IINNTTRROO__FFFFIIOO(3F) man page for more details. iibbmm IBM record formats. Deferred implementation on IRIX systems. mmrr Memory-resident files. Deferred implementation on IRIX systems. nnoossvvee CDC NOS/VE record formats. Not available on IRIX systems. nnuullll Syntactic no-op. Available on IRIX systems. ssddss SDS-resident files. Not supported on CRAY T3E systems. Not available on IRIX systems. ssiittee Site-specific layer. Available on IRIX systems. ssttddiinn, ssttddoouutt, or ssttddeerrrr Open file descriptors 0, 1, or 2, respectively (see ffdd layer). Available on IRIX systems. ssyyssccaallll System call I/O. Available on IRIX systems. ssyysstteemm Generic system layer. Available on IRIX systems. tteexxtt Special character-terminated record. Available on IRIX systems. ttmmff IRIX tape management facility. Available on IRIX systems. uusseerr User layer. Available on IRIX systems. vvmmss VAX/VMS record format. Available on IRIX systems. For more information on the classes, see the IINNTTRROO__FFFFIIOO(3F) man page. --LL _s_e_t_t_i_n_g Activate or suppress the passing of the OO__LLDDRRAAWW flag to the ooppeenn(2) system call. Used by Fortran I/O and FFIO. _s_e_t_t_i_n_g may be oonn or ooffff. This option is supported in programs linked with Cray Research's Programming Environment 3.0 and later releases. Not available on IRIX systems. --NN _n_u_m_c_o_n Specifies foreign numeric conversion. Used by Fortran I/O. Fortran unformatted I/O converts numeric data from this assumed numeric format on input, and converts it to this numeric format on output. If this option is used and the --CC option is not used, appropriate character defaults are used. Each value for _n_u_m_c_o_n selects a particular type of foreign data conversion. Each option has a mapping that associates each of the native data types with a corresponding foreign data type and length in bits. Appropriate data conversion is done on unformatted input and output operations. For example, entering --NN iibbmm selects the following mapping: CCRRII DDaattaa TTyyppee IIBBMM DDaattaa TTyyppee 64-bit IINNTTEEGGEERR 32-bit IINNTTEEGGEERR**44 64-bit RREEAALL 32-bit RREEAALL**44 128-bit DDOOUUBBLLEE 64-bit DDOOUUBBLLEE PPRREECCIISSIIOONN 128-bit CCOOMMPPLLEEXX 64-bit CCOOMMPPLLEEXX 64-bit LLOOGGIICCAALL 32-bit LLOOGGIICCAALL**44 8-bit AASSCCIIII CCHHAARRAACCTTEERR 8-bit EEBBCCDDIICC CCHHAARRAACCTTEERR Short IINNTTEEGGEERR**22 16-bit IINNTTEEGGEERR**22 The following tables list the values for _n_u_m_c_o_n on different hardware platforms. Note that in these tables, "VAX" is an alias for "VMS". For example, vvmmss__ddpp is synonymous with vvaaxx__ddpp. Cray PVP systems (non-IEEE) --------------------------------------------------- --CC --NN option default Meaning --------------------------------------------------- none none No data conversion default default No data conversion ccrraayy ASCII No data conversion iibbmm EBCDIC IBM data conversion iibbmm__ddpp EBCDIC IBM data conversion; floating-point is 64-bits CCDDCC cdc CDC 60-bit data conversion nnoossvvee ASCII CDC NOS/VE data conversion cc220055 ASCII CDC CYBER 205 (ETA) data conversion vvmmss ASCII VAX/VMS data conversion vvmmss__ddpp ASCII VAX/VMS data conversion; floating-point is 64-bits iieeeeee ASCII Generic 32-bit IEEE data conversion iieeeeee__3322 (alias for above) iieeeeee__ddpp ASCII IEEE data conversion; floating-point is 64-bits mmiippss ASCII SGI MIPS IEEE data conversion (128-bit floating-point is "double double" format) iieeeeee__6644 ASCII CRAY 64-bit IEEE data conversion iieeeeee__llee ASCII Little endian 32-bit IEEE data conversion uullttrriixx (alias for above) iieeeeee__llee__ddpp ASCII Little endian 32-bit IEEE data conversion; floating- point is 64-bits uullttrriixx__ddpp (alias for above) tt33ee ASCII CRAY 64-bit IEEE data conversion; denormalized numbers flushed to zero tt33dd (alias for above) uusseerr ASCII User defined data conversion ssiittee ASCII Site defined data conversion --------------------------------------------------- Cray MPP systems --------------------------------------------------- --CC --NN option default Meaning --------------------------------------------------- none none No data conversion default default No data conversion ccrraayy ASCII No data conversion iieeeeee ASCII Generic 32-bit IEEE data conversion iieeeeee__3322 (alias for above) tt33ee ASCII CRAY 64-bit IEEE data conversion; denormalized numbers flushed to zero tt33dd ASCII No data conversion uusseerr ASCII User defined data conversion ssiittee ASCII Site defined data conversion --------------------------------------------------- CRAY T90/IEEE --------------------------------------------------- --CC --NN option default Meaning --------------------------------------------------- none none No data conversion default default No data conversion ccrraayy ASCII No data conversion iibbmm EBCDIC IBM data conversion iibbmm__ddpp EBCDIC IBM data conversion; floating-point is 64-bits iieeeeee ASCII Generic 32-bit IEEE data conversion iieeeeee__3322 (alias for above) iieeeeee__ddpp ASCII IEEE data conversion; floating-point is 64-bits iieeeeee__6644 ASCII CRAY 64-bit IEEE data conversion uusseerr ASCII User defined data conversion ssiittee ASCII Site defined data conversion --------------------------------------------------- SGI IRIX (MIPS) --------------------------------------------------- --CC --NN option default Meaning --------------------------------------------------- none none No data conversion default default No data conversion ccrraayy ASCII Cray PVP (non-IEEE) data conversion mmiippss ASCII No data conversion uusseerr ASCII User defined data conversion ssiittee ASCII Site defined data conversion iieeeeee ASCII Generic 32-bit IEEE data conversion iieeeeee__3322 (alias for above) iieeeeee__6644 ASCII CRAY 64-bit IEEE data conversion iieeeeee__llee ASCII Little-endian 32-bit IEEE data conversion vvaaxx ASCII DEC VAX/VMS data conversion vvmmss (alias for above) --------------------------------------------------- --PP _s_c_o_p_e Specifies the scope of a Fortran unit. Used by Fortran I/O and auxiliary I/O. Deferred implementation on IRIX systems. Allows specification of private I/O on UNICOS systems. Valid values for _s_c_o_p_e are: pprriivvaattee Causes a Fortran unit to be private to a task. Any unit number assigned this option is visible only to the task which opens it. Other tasks may open the same unit number to the same or different files. gglloobbaall Supported on UNICOS systems only. Causes a Fortran unit to be global to an application. An application is defined as a process or multitasked group on UNICOS systems. tthhrreeaadd Supported on UNICOS systems only. Causes a Fortran unit to be private to a multitasking thread. Any unit number assigned this option is visible only to the thread which opens it. Other threads may open the same unit number to the same or different files. The default for all Fortran units is --PP pprriivvaattee on UNICOS/mk systems and --PP gglloobbaall on UNICOS systems. --PP pprriivvaattee may not be specified on UNICOS systems for a unit connected to ssttddiinn, ssttddoouutt, or ssttddeerrrr. The following command selects private I/O for all Fortran units except scratch units, and ssttddiinn, ssttddoouutt, and ssttddeerrrr: assign -P private p:% --SS _s_e_t_t_i_n_g Suppress use of comma as a separator in list-directed output. _s_e_t_t_i_n_g can be either oonn or ooffff. The default setting is ooffff. --TT _s_e_t_t_i_n_g Activates or suppresses truncation after write for sequential Fortran files. Used by Fortran I/O. Available on IRIX systems. The selection of --TT oonn is standard and is the default setting for most file types. Selecting --TT ooffff is useful in applications where GGEETTPPOOSS and SSEETTPPOOSS are used to simulate random access to a file with sequential I/O. The following table describes the --TT option settings allowed for the file types specified with the --ss option. Unsupported combinations are diagnosed when a Fortran unit is opened. ----------------------------------------- File type --TT oonn --TT ooffff ----------------------------------------- bbiinn Allowed Default ccooss or bblloocckkeedd Default Not allowed ssbbiinn Default Allowed ttaappee or bbmmxx Default Not allowed tteexxtt Default Allowed uu Allowed Default uunnbblloocckkeedd Default Allowed ----------------------------------------- FFIO layers specified with the --FF option vary in their support for suppressing truncation with --TT ooffff. --UU _s_e_t_t_i_n_g Produce a non-UNICOS form of list-directed output. _s_e_t_t_i_n_g can be either oonn or ooffff. This setting is a global setting which sets the value for the --yy, --SS, and --WW options all to the same value. The default setting is ooffff. --WW _s_e_t_t_i_n_g Suppress compressed width in list-directed output. _s_e_t_t_i_n_g can be either oonn or ooffff. The default setting is ooffff. --YY _s_e_t_t_i_n_g Skip unmatched namelist group in the namelist input record. _s_e_t_t_i_n_g can be either oonn or ooffff. The default setting on UNICOS and UNICOS/mk systems is ooffff. The default setting on IRIX systems is oonn. --ZZ _s_e_t_t_i_n_g Recognize -0.0 for IEEE floating point systems. _s_e_t_t_i_n_g can be either oonn or ooffff. This option recognizes -0.0 for IEEE floating point systems and writes the minus sign for edit-directed, list-directed, and namelist output. The minus sign is suppressed by default on IRIX systems. The following example suppresses the write of the minus sign for -0.0 for unit 9 on an IEEE floating point system: assign -Z on u:9 The minus sign is suppressed for IRIX systems to prevent problems from hardware instructions and optimizations which may return a -0.0 from a 0.0 value. EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS The FFIILLEENNVV environment variable must be set to use the aassssiiggnn command on IRIX systems. On UNICOS systems, FFIILLEENNVV does not have to be set. EEXXAAMMPPLLEESS Example 1: The following example assigns an actual name (//ttmmpp//ffoooo//ffiilleexxyyzz) and a buffer size of 8 sectors to unit 1, removing any previously assigned options to unit 1: assign -a /tmp/foo/filexyz -b 8 u:1 Example 2: To assign unit 11 an unblocked file structure without modifying any other options currently in effect for unit 11, use the --II option as follows: assign -I -s unblocked u:11 Example 3: The following example sets up and uses the aassssiiggnn environment file, aaffiillee, for a specific program. The aassssiiggnn command specifies that all files with the names matching the BBLLOOCCKKEEDD%% pattern are COS blocked files: env FILENV=afile assign -F cos p:BLOCKED% env FILENV=afile a.out Example 4: Attributes may be stored in the pprroocceessss environment using the aassssiiggnn or aassggccmmdd commands. The following example uses the aassssiiggnn command: setenv FILENV \$EVAR eval `assign -F f77 foo` The following example uses the aassggccmmdd command: eval `asgcmd -F f77 foo` SSEEEE AALLSSOO aassggccmmdd(1), ddff(1), llnn(1), sseettff(1), ttppmmnntt(1), wwrriittee(1) iiaalllloocc(2), ooppeenn(2) in the aaccppttbbaadd(3F), aassssiiggnn(3F), ffffaassssiiggnn(3C), ffffooppeenn(3C), ffrreeaadd(3C), iinnttrroo__ffffiioo(3F), ooppeennmmss(3F), ooppeennddrr (see ooppeennmmss(3F)), sskkiippbbaadd(3F) _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _I/_O _G_u_i_d_e This man page is available only online.